home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / diskutil / dirsort.lzh / DIRSORT.TXT < prev   
Text File  |  1990-09-29  |  6KB  |  155 lines
  1. #######################################################################
  2. #       File: DIRSORT.TXT                                             #
  3. #                                                                     #
  4. #       DDD    IIIII  RRRR    SSSS   OOO   RRRR   TTTTT               #
  5. #       D  D     I    R   R  S      O   O  R   R    T                 #
  6. #       D   D    I    R   R  S      O   O  R   R    T                 #
  7. #       D   D    I    RRRR    SSS   O   O  RRRR     T                 #
  8. #       D   D    I    R  R       S  O   O  R  R     T                 #
  9. #       D  D     I    R   R      S  O   O  R   R    T                 #
  10. #       DDD    IIIII  R   R  SSSS    OOO   R   R    T                 #
  11. #                                                                     #
  12. #       Documentation for DIRSORT                                     #
  13. #                                                                     #
  14. #       Author:         Andrew Dawson                                 #
  15. #       Last Modified:  28th May 1990                                 #
  16. #                                                                     #
  17. #######################################################################
  18.  
  19.  
  20. Introduction
  21. ============
  22.  
  23. With the ever increasing number of AUTO-folder programs becoming available,
  24. along with the requirement that some are loaded before others, management
  25. of the AUTO folder has started to become a tedious process. The only way
  26. to re-order it is to copy everything to another folder, delete everything,
  27. and copy everything back again. As the ST Desktop copies in alphabetical
  28. order when several files are selected, this usually has to be done on a
  29. file by file basis.
  30.  
  31. DIRSORT was written in an attempt to put an end to this by providing a
  32. means of rearranging the order of files in a directory. I am sure it is not
  33. the only program of its kind, although I have yet to see a program that
  34. supports a GEM interface and works with hard disks (particularly with
  35. sectors of >512 bytes) and works on all versions of the operating system.
  36.  
  37. In fact, DIRSORT is not restricted to the AUTO folder - it can alter the
  38. order of any directory. This should make it possible to select the running
  39. order of graphics "slideshow" programs, and possibly the loading order of
  40. Desk Accessories (I'm not sure about this last one, as I'm not sure what
  41. criteria GEM uses to determine the loading order).
  42.  
  43.  
  44. Starting DIRSORT
  45. ================
  46.  
  47. Double click on DIRSORT.PRG. After a short delay, a display of the top level
  48. directory of the current drive will appear, along with a menu bar at the top
  49. of the screen.
  50.  
  51.  
  52. Changing the Order of Files
  53. ===========================
  54.  
  55. The position of a file in the directory is changed using a drag operation.
  56. Click on the name of a file. The mouse pointer will turn into a hand-shaped
  57. pointer and an outline will appear around the directory entry for the file.
  58. Keeping the mouse button pressed, drag the outline to the desired position
  59. for the file. Release the mouse button.
  60.  
  61. NOTE: When editing a folder, the first two entries will be "." and "..".
  62.       It is strongly advised that these are left at the top of the list.
  63.  
  64.  
  65. Moving Up and Down the Directory Structure
  66. ==========================================
  67.  
  68. Double clicking on a folder causes the directory for that folder to be
  69. displayed for re-ordering. You will asked if you wish to save any changes
  70. made to the current directory if it has been changed. Double clicking on
  71. the ".." entry goes back up a level to the folder above. (You can also
  72. click on the "." entry if you like, but this simply re-reads the directory
  73. currently being edited.) 
  74.  
  75.  
  76. Desk Menu Options
  77. =================
  78.  
  79. About DIRSORT
  80.    This reports the version number of DIRSORT being used
  81.  
  82. Any installed desk accessories are also available. Do NOT use any Desk
  83. Accessory that creates files or folders in the directory currently being
  84. edited. This could cause disk corruption to occur.
  85.  
  86.  
  87. File Menu Options
  88. =================
  89.  
  90. Select Drive
  91.    A list of drives appears. Select the appropriate drive and click OK.
  92.    This will always re-read the disk, and should be used after changing the
  93.    disk in a drive.
  94.  
  95. Write Directory
  96.    This writes the directory being edited back to disk.
  97.  
  98. Quit
  99.    Self explanatory.
  100.  
  101.  
  102. Sort Menu Options
  103. =================
  104.  
  105. Sort Directory
  106.    Although most directory re-arranging will probably be done manually, it
  107.    is also possible to sort the entries by Filename, Extension, Size or
  108.    Date in either ascending or descending order. There are some constraints
  109.    on the resulting order:
  110.  
  111.       Volume labels are always placed first if present (there should be no
  112.       more than one of these, and it should only appear in the root
  113.       directory - unfortunately, there are a few badly-behaved volume
  114.       labelling programs out there!).
  115.  
  116.       Folders come next, in the selected order. The special entries "." and
  117.       ".." will always be placed first.
  118.  
  119.       Next come standard files, again in the chosen order.
  120.       
  121.       Deleted files and folders are placed at the end of the list.
  122.  
  123.  
  124. Limitations & Possible Problems
  125. ===============================
  126.  
  127. This program has been tested under TOS versions 1.0, 1.2 and 1.4 with
  128. a variety of floppy disk formats, plus a hard disk using AHDI 3.0 (including
  129. large sectors).
  130.  
  131. Some floppy disk formatters don't seem to zero the directory properly, which
  132. may lead to a large number of "Deleted files" appearing at the end of the
  133. directory listing. This shouldn't be a problem.
  134.  
  135. There is a limitation of 32K on the size of the directory buffer, so it
  136. may not be possible to edit directories containing several hundred files.
  137.  
  138.  
  139. FREEWARE
  140. ========
  141.  
  142. This software may be freely distributed. The documentation must be included
  143. in any distribution. Only not profit distribution is allowed.
  144.  
  145.  
  146. Disclaimer
  147. ==========
  148.  
  149. As this software is made available free of charge, it is provided on an
  150. "as-is" basis, without warranty of any kind, including any implied/explicit
  151. suggestions of usefulness for any purpose. Use this program only if you
  152. are willing to assume all risks, and damages, if any, arising as a result,
  153. even if caused by negligence or other fault.
  154.  
  155.